home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / !commodities! / docs / caw.doc < prev    next >
Text File  |  1996-09-07  |  7KB  |  294 lines
  1.  
  2.  
  3.                  CAW - CloseAllWindows V1.0 (37.17)
  4.  
  5.            by Roger Larsson 1992/93  (FidoNet @ 2:203/319.4)
  6.  
  7.  
  8.  
  9. WHAT IS IT?
  10.  
  11. CAW is a commodity that lets You close windows on the Workbench screen
  12. with a keyboard combination.
  13.  
  14.  
  15. WHY?
  16.  
  17. Isn't it nice to be able to close all those windows that mess upp the
  18. screen in a fast way?
  19.  
  20.  
  21. DISTRIBUTION
  22.  
  23. CAW is FreeWare. It may be distributed (Please do!) for non commercial
  24. purposes only. All files in this package must be kept together in original
  25. and unmodified form. CAW IS copyright! If you like it, please send me a
  26. postcard from your hometown. My address is found in the end of this text!!
  27.  
  28.  
  29. REQUIREMENTS
  30.  
  31. CAW needs AmigaDOS 2.0 or higher to run.
  32.  
  33.  
  34. INSTALATION
  35.  
  36. Place the CAW drawer anywhere You like. If You want to run CAW at bootup,
  37. You should drag the CAW icon into the WBStartup drawer.
  38.  
  39.  
  40. RUNNING CAW
  41.  
  42. Just double click its icon. If the tooltype CX_POPUP is set to "NO" CAW
  43. will just sit there in the background waiting for You to use it. If
  44. CX_POPUP is set to "YES", then CAW will open its main window at startup.
  45.  
  46.  
  47. TOOLTYPES
  48.  
  49. To change the tooltypes, select the CAW icon and choose "Info" from the
  50. Workbench menu.
  51.  
  52.  
  53.     CAW recognizes the following tooltypes:
  54.  
  55.     CX_PRIORITY=pri
  56.     CX_POPUP=Yes|No
  57.     CX_POPKEY= Qualifier Key
  58.     CLOSEKEY=  Qualifier Key
  59.  
  60.     These overrides the preferences function
  61.     in the program. If you want to set them
  62.     in the preferences window, remove them
  63.     or mark them out in the info window, for example:
  64.     (CX_POPUP=YES).
  65.  
  66.  
  67.     CX_PRIORITY
  68.  
  69.     The priority pri is a number from -128 to 127.
  70.     Higher priority gives CAW access to input events
  71.     before other commodities.
  72.  
  73.     Default: CX_PRIORITY=0
  74.  
  75.  
  76.     CX_POPUP
  77.  
  78.     If CX_POPUP=YES, the CAW window opens when
  79.     it is first launched.
  80.  
  81.     Default: CX_POPUP="Yes"
  82.  
  83.  
  84.     CX_POPKEY
  85.  
  86.     CX_POPKEY is followed by a string describing
  87.     the qualifiers and key to use as a hotkey,
  88.     for making the CAW's window appear (pop up).
  89.  
  90.     Default: CX_POPKEY="control lalt a"
  91.  
  92.  
  93.     CLOSEKEY
  94.  
  95.     CLOSEKEY is followed by a string describing
  96.     the qualifiers and key to use as a hotkey,
  97.     for closing all windows on Workbench.
  98.  
  99.     Default: CLOSKEY="control a"
  100.  
  101.  
  102. THE MAIN WINDOW
  103.  
  104. There are two ways to open the main window when CAW is running.
  105. Pressing the popkey combination or double clicking the program icon. If
  106. You double click the icon, a requester will pop up, giving You the
  107. possibility to choose one of three alternatives.
  108.  
  109. POPUP --- Opens the main window
  110.  
  111. HIDE  --- Closes the requester and CAW runs in hidden mode.
  112.  
  113. QUIT  --- Quit the CAW program.
  114.  
  115.  
  116. In the upper part of the main window is a listview gadget. This is where
  117. You enter the names of windows that You wish NOT to be closed by CAW. Type
  118. in a window name in the stringgadget under the list and when You press
  119. return or tab, the window name will appear in the list. You can delete a
  120. window name by selecting it in the list and then click on the "Delete"
  121. gadget to the right of the list. You can unselect a name by clicking on
  122. the "Undo" gadget.
  123.  
  124. If You checkmark the "Add #? Wildcards" gadget, the AmigaDOS #? wildcard
  125. will be added both in front and after the window name. This is very
  126. useful because many programs open windows with names that are very long.
  127.  
  128. An example: "AllWind" would cause the "CloseAllWindows 37.16 (28.10.92)"
  129. window to remain open if the Wildcard gadget is activated. Of course this
  130. would also be the case for  all other windows that have the "AllWind"
  131. string in their name.
  132.  
  133. The "Close Options" field has three gadgets. "Close active window" means
  134. that the active window will also be closed when You press the close keys.
  135. If it is not activated all windows except the active window will be
  136. closed. The "PopUp" gaget tells CAW to open its main window at startup.
  137. The "Cx_Pri" gadget is for setting the Cx_Priority of CAW.
  138.  
  139. The "Key Qualifiers" field is where You choose the diffrent key
  140. combinations to close the windows and to pop up CAW's main window. Click
  141. on the "Close" gadget to open the qualifier key window. In this window You
  142. checkmark the gadgets that correspond to the keys that You would like to
  143. use as qualifiers. When You're done, close the window and You will see
  144. that the textgadget to the right of the "Close" gadget in the main
  145. window has a string describing the keys of Your choice. Now there's only
  146. one thing left to do to make the "Close windows" function work. Type in a
  147. key in the key string gadget to the right of the textgadget. The
  148. textgadget will be updated with the key of Your choice. Now go through the
  149. same procedure with the "PopUp" fuction to set the keyboard combination to
  150. open the CAW main window.
  151.  
  152. Qualifier is one or several strings from the table below.
  153.  
  154.     lshift
  155.     rshift
  156.     capslock
  157.     control
  158.     lalt
  159.     lcommand
  160.     rcommand
  161.     numericpad
  162.     repeat
  163.     midbutton
  164.     rbutton
  165.     leftbutton
  166.     relativemouse
  167.  
  168. Key is one string from the table below.
  169.  
  170.  
  171.     Any single character, e.g. "a" or "b" or "[" or "2" etc.
  172.  
  173.     "tab"
  174.     "esc"
  175.     "del"
  176.     "f1"
  177.     "f2"
  178.     "f3"
  179.     "f4"
  180.     "f5"
  181.     "f6"
  182.     "f7"
  183.     "f8"
  184.     "f9"
  185.     "f10"
  186.  
  187.  
  188. When You're done You probably want to save the settings in some way. Click
  189. the "Prefs" gadget to open the "Prefs" requester. This requester gives You
  190. three options, "Save" wich saves the settings to Envarc: which means that
  191. the changes are permanent. "Load" re-reads the last saved settings from
  192. Envarc:. "Use" saves the new settings to ENV: but not to Envarc: which
  193. means that the changes are temporary and will only be used until You make
  194. new changes or reboot Your Amiga.
  195.  
  196.  
  197. THE MENUES
  198.  
  199.         ABOUT
  200.  
  201.     Pops up requester with information
  202.     about CloseAllWindows.
  203.  
  204.  
  205.  
  206.         PREFS
  207.  
  208.     A requester pops up and ask you to:
  209.  
  210.  
  211.     Save:    Save configuration in envarc:
  212.         Permanent.
  213.  
  214.     Load:    Load configuration from envarc:
  215.  
  216.     Use:    Save configuration in env:
  217.         Temporary.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.         HIDE
  224.  
  225.  
  226.     Close the CAW window.
  227.  
  228.     The program remains active.
  229.  
  230.  
  231.  
  232.         QUIT
  233.  
  234.  
  235.     Exit CloseAllWindows.
  236.  
  237.  
  238. CLOSING WINDOWS
  239.  
  240. Let's say that You have choosen "lalt" (left alt key) for the close qualifier
  241. and "a" for the key, just hold down left alt and press a to close the
  242. windows on Your Workbench screen.
  243.  
  244.  
  245. HELP
  246.  
  247. This package contains an AmigaGuide file named caw.guide. Make sure this
  248. file is in Your AmigaGuide path. This will give You online documentation
  249. when You press the HELP-key when the mousepointer is over a gadget or
  250. a menuitem.
  251.  
  252.  
  253. PROBLEMS
  254.  
  255. Sometimes is it hard to identify a window by its name.
  256. This creates some problems if you dont want to close it with CAW.
  257.  
  258. Some windows have strange names that can be difficult to figure out. For
  259. example the iconified DirectoryOpus window appears to have the name
  260. DirOpus but the window name is really just a row of spaces. The solution
  261. to this is to enter the following line in Your exception list:
  262. #?          #?
  263. This will prevent CAW from closing the DirOpus iconified window.
  264.  
  265. Some musicplayers changes its window name to that of the loaded module but
  266. strips the .mod extension so You can never tell what name the window will
  267. have. One way to get around this is to rename all modules from #?.mod to
  268. mod.#?.mod and type mod.#? in the exception list.
  269. Do it if Yoy have the energy! ;-)
  270.  
  271.  
  272. CREDITS
  273.  
  274. The author wishes to thank:
  275.  
  276.     Kjell Cederfeldt for suggestions and hints.
  277.     Kjell Harnesk who helped me whih this document.
  278.  
  279.  
  280. ADDRESS
  281.  
  282.     If you have suggestions or remarks about
  283.     this program, or if you find any bugs,
  284.     please let me know.
  285.  
  286.     Mail:    Roger Larsson
  287.              Hamngatan 12
  288.              S-582 26 Linköping
  289.               SWEDEN
  290.  
  291.     NetMail: (FidoNet @ 2:203/319.4)
  292.  
  293.  
  294.